Games that are made to target devices that run iOS or Android
can also connect to one of two leaderboard and achievement API's.
For iOS you have the iTunes Game Center, and for Android you
can use the Amazon Game Circle or Google Play, with
all of them using the using the functions found on this page. These
functions permit your game to send information on scores and
achievements to the leaderboards that you have set up in the
Developers Account for the game you are making and is an excellent
way to get players involved in the social side of gaming as they
can then see what other people who have played your game have
achieved and try to better them.
When using these functions, you should note that they do not
track achievements and scores automatically for you. They only show
the data that you send them from your game, so you must code your
own achievements and hi-score system to keep track of the
individuals status in game, then use these functions to add the
data to the chosen network (however you can request progress
information for achievements using the achievement_load_progress
function).
Some of these functions will trigger a callback
Social Asynchronous Event, which will contain a ds_map
of data relating to the function that triggered it. Those functions
that trigger the event also detail the map key/value pairs that are
returned by the callback, however a callback Social Event
can also be triggered by your game receiving external notifications
about challenges etc... The exact details of the ds_map
returned for these events are explained in the
Social Asynchronous Event section.
NOTE: For these functions to work with iOS you must have a valid Game Center account and an iOS app id for your game.
NOTE: For these functions to work with Android you must submit your game to the Amazon App store, or to Google Play, and have set up the necessary sections as well as have the API activated in the Global Game Settings for your game.
The functions listed below are the basic ones used for integrating your game with the chosen target social gaming platform:
- achievement_login_status
- achievement_login
- achievement_logout
- achievement_available
- achievement_post
- achievement_post_score
- achievement_increment
- achievement_show_achievements
- achievement_show_leaderboards
- achievement_show_challenge_notifications
- achievement_get_challenges
- achievement_get_pic
- achievement_load_friends
- achievement_load_leaderboard
- achievement_load_progress
- achievement_send_challenge
- achievement_reset
Apart from these functions for devices, GameMaker: Studio also integrates a basic highscore storage system that is local to your game and compatible with all platforms. This system can store up to ten places (with names and scores) locally, which you can then draw on-screen as you wish. For more information see: